home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / ksd.z / ksd
Encoding:
Text File  |  2001-04-17  |  13.0 KB  |  265 lines

  1.  
  2.  
  3.  
  4.      KKKKSSSSDDDD((((1111MMMM))))         KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((00005555////00003333////00000000 11110000....2222))))         KKKKSSSSDDDD((((1111MMMM))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           ksd -  AppleShare file server
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ////uuuussssrrrr////eeeettttcccc////aaaapppppppplllleeeettttaaaallllkkkk////kkkkssssdddd [ ----ooooAAAAccccffffiiiiLLLLllllppppssssSSSSRRRRvvvvVVVVGGGGhhhhHHHHxxxx ] [ ----mmmmoooovvvveeeeiiiinnnnuuuusssseeee ]
  13.               [ ----iiiippppaaaaddddddddrrrr #.#.#.# ] [ ----iiiippppppppoooorrrrtttt _p_o_r_t ] [ ----nnnnooooddddddddpppp ]
  14.               [ ----nnnncccc ] [ ----mmmm _m_a_x__f_i_l_e_s__p_e_r__u_s_e_r ] [ ----tttt _t_c_p_o_p_t ]
  15.               [ ----dddd _h_e_x__d_e_b_u_g__l_e_v_e_l ] [ ----ZZZZ _z_o_n_e ] _s_e_r_v_e_r-_n_a_m_e
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           _K_s_d is an AppleShare network file system server.  It uses
  19.           the K-Talk AppleTalk protocols to service file system
  20.           requests from remote clients.
  21.  
  22.           The K-AShare server advertises its services with the Name
  23.           Binding Protocol Daemon _n_b_p_d(1m) using the _s_e_r_v_e_r-_n_a_m_e
  24.           specified (unless the ----nnnnooooddddddddpppp argument is given).  The server
  25.           name may contain blanks, but it must then be quoted in the
  26.           shell invocation.
  27.  
  28.           The boot-time invocation of the servers normally resides in
  29.           the file /usr/etc/appletalk/services, which is used by the
  30.           _a_t_i_n_i_t(1m) program.  Only one _k_s_d(1m) daemon can be running
  31.           on a machine; however _k_s_d will fork slave processes to
  32.           distribute the system load between several processes.
  33.  
  34.           The _w_h_o(1) command shows users currently using the _k_s_d(1m)
  35.           daemon.
  36.  
  37.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  38.           ----AAAA   Attempts to get an AFS token by calling
  39.                "/usr/afsws/bin/klog" with the user name and password.
  40.                Will not open connections for users who cannot validate
  41.                with AFS.
  42.  
  43.           ----cccc   Prevents users from saving their password permanently
  44.                on the Macintosh.
  45.  
  46.           ----tttt   Set the security level for connections via TCP/IP.
  47.                Since TCP/IP connections can happen over the Internet,
  48.                additional security is often prudent.  _T_c_p_o_p_t can be
  49.                one of the following:  ddddiiiissssaaaabbbblllleeee prevents TCP logins
  50.                completely, llllooooccccaaaallllppppaaaasssssssswwwwdddd does not allow "guest", "root",
  51.                or logins without a password from clients that are not
  52.                directly connected to the server (and is the default),
  53.                llllooooccccaaaallll allows only users on networks directly connected
  54.                to the server access, ppppaaaasssssssswwwwdddd allows users to connect
  55.                from anywhere as long as they have a password and they
  56.                are not "guest" or "root", nnnnoooonnnneeee allows all TCP/IP
  57.                connections, and is recommended only on isolated nets
  58.                or behind a firewall.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 5/4/100)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      KKKKSSSSDDDD((((1111MMMM))))         KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((00005555////00003333////00000000 11110000....2222))))         KKKKSSSSDDDD((((1111MMMM))))
  71.  
  72.  
  73.  
  74.           ----dddd   Set the debugging level to _h_e_x__d_e_b_u_g__l_e_v_e_l. The
  75.                debugging levels are documented only in the source
  76.                code.
  77.  
  78.           ----ffff   A performance option.  AFP protocol requires that file
  79.                space be reserved before writing data.  This implies
  80.                that a dummy file has to be written first.  With the
  81.                -f flag, file space is not reserved and the file is
  82.                written only once.
  83.  
  84.           ----iiii   Allow users who have blank passwords to login.
  85.  
  86.           ----LLLL   Do not search for the "user's real name" in the GECOS
  87.                field of password entries.  This avoids a scan through
  88.                every entry in the _p_a_s_s_w_d(4) database at each login,
  89.                but requires AppleShare users to use their exact UN*X
  90.                login account name.
  91.  
  92.           ----llll   Do not do make any calls to the UNIX lock manager.
  93.                This option is intended for users who do not have a
  94.                stable lock manager.   The server allows the client to
  95.                set locks, but they are not really set.  Unpredictable
  96.                behavior may occur when using clients that depend on
  97.                file locking, or when multiple users attempt to access
  98.                the same file.  Use of this flag is discouraged.
  99.  
  100.           ----mmmm   Set the maximum number of files that a connected user
  101.                can open at one time to _m_a_x__f_i_l_e_s__p_e_r__u_s_e_r. (The
  102.                default is 32). This option is useful if you have users
  103.                who are running ill-behaved Macintosh applications
  104.                (i.e. programs that fail to close files).
  105.  
  106.           ----oooo   Fork a slave process for each user.  This should only
  107.                be used on systems with lots of memory.
  108.  
  109.           ----pppp   Prevent users from changing their password from the
  110.                Macintosh.  This flag should be used if the unix server
  111.                is using any non-standard password scheme.
  112.  
  113.           ----ssss   Run _k_s_d(1m) in secure mode.  Don't allow root logins
  114.                from the client.
  115.  
  116.           ----RRRR   This option gives the root user administrative
  117.                privileges from AppleShare.  Without this option, root
  118.                behaves just like any other user.  This option has no
  119.                effect if root logins are disabled with -s or with the
  120.                tcp security options.
  121.  
  122.           ----vvvv   Make dot files visible to user. This is a potentially
  123.                dangerous option, since in certain cases files that
  124.                start with a dot will be mistaken for device drivers by
  125.                the Finder, causing the Macintosh to crash.  The
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 5/4/100)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      KKKKSSSSDDDD((((1111MMMM))))         KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((00005555////00003333////00000000 11110000....2222))))         KKKKSSSSDDDD((((1111MMMM))))
  137.  
  138.  
  139.  
  140.                default is to hide all dot files.
  141.  
  142.           ----SSSS   Do follow Symbolic links.  Normally, _k_s_d(1m) doesn't
  143.                follow symbolic links, because of the danger of cycles.
  144.                Since the Mac doesn't understand symbolic links, the
  145.                Finder and other Mac applications cannot handle these
  146.                cycles in the file systems, and can easily crash the
  147.                Mac.  If your mounted file system is really free of
  148.                cycles created by symbolic links, you might want to
  149.                follow symbolic links, but this is another potentially
  150.                dangerous option.
  151.  
  152.           ----VVVV   Log verbose messages, mostly about failed login
  153.                attempts.  Normally, _k_s_d(1m) does not do any error
  154.                logging when a login fails.  This option causes
  155.                messages to be logged in /_u_s_r/_a_d_m/_a_p_p_l_e_t_a_l_k/_a_t__l_o_g
  156.                indicating the net and node of the machine that the
  157.                login request came from (and the user name if just the
  158.                password was incorrect). This option is mainly for
  159.                government installations that require it.
  160.  
  161.           ----GGGG   Show up to 4 Gigabytes for a volume size.  By default,
  162.                ksd limits the size it reports to 1.7Gig, which is the
  163.                most a pre-7.5-Mac could handle.
  164.  
  165.           ----hhhh   Don't allow users to mount their home directories, and
  166.                don't look for .KSVols files.   Only public volumes (in
  167.                KASPubVols) are accessable.
  168.  
  169.           ----HHHH   Do not list public volumes  that the user cannot read.
  170.                The default bevavior is to show the volumes, but gray
  171.                them out.
  172.  
  173.           ----xxxx   Do not allow Guest access to AppleShare volumes.
  174.                Without this flag, _k_s_d(1m) will use any of the
  175.                following accounts for guest access, whichever it finds
  176.                first:  ksdguest, ksd_guest, guest, nobody (if none
  177.                exist, it uses UID 65534 and GID 65534 for guest
  178.                access, with no personal volumes).
  179.  
  180.           ----mmmmoooovvvveeeeiiiinnnnuuuusssseeee
  181.                Allow files that are open to be moved (rather than
  182.                returning the specified afpFileBusy).  This mirrors the
  183.                behavior of Mac personal file sharing.
  184.  
  185.           ----nnnncccc  Disables the ``clear text'' method of accepting
  186.                passwords during login.
  187.  
  188.           ----iiiippppaaaaddddddddrrrr
  189.                Forces the server to advertize the given IP address
  190.                (must be specified in ``dot'' notation) as it's
  191.                connection address.  Without this argument, _k_s_d uses
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 5/4/100)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      KKKKSSSSDDDD((((1111MMMM))))         KKKK----AAAASSSShhhhaaaarrrreeee bbbbyyyy XXXXiiiinnnneeeetttt ((((00005555////00003333////00000000 11110000....2222))))         KKKKSSSSDDDD((((1111MMMM))))
  203.  
  204.  
  205.  
  206.                one of the configured IP interface addresses, whichever
  207.                one seems closest to the client.
  208.  
  209.           ----iiiippppppppoooorrrrtttt
  210.                Use the specified _p_o_r_t number as the AppleShare
  211.                connection port, instead of the default 548.
  212.  
  213.           ----nnnnooooddddddddpppp
  214.                Turns off connection via AppleTalk.  This also prevents
  215.                _k_s_d from advertizing its service via NBP, effectively
  216.                hiding it from choosers.
  217.  
  218.           ----ZZZZ _z_o_n_e
  219.                Specifies the zone in which to publish this server.
  220.                The default zone will be used if this option is not
  221.                present.  You can publish the server in multiple zones
  222.                by using multiple _z_o_n_e options (e.g. -_Z _n_e_t_1 -_Z _n_e_t_2 ).
  223.  
  224.      FFFFIIIILLLLEEEESSSS
  225.           /usr/adm/appletalk/icons/*    Icon database
  226.  
  227.           /usr/adm/appletalk/KASPubVols List of K-AShare public
  228.                                         volumes
  229.  
  230.           /usr/adm/appletalk/at_log     Log of AppleTalk errors, etc.
  231.  
  232.           /usr/adm/appletalk/motd       Message sent to users when
  233.                                         they first connect to K-AShare
  234.  
  235.           /usr/adm/appletalk/msg        Message sent to each user when
  236.                                         ksd receives a SIGUSR1, or
  237.                                         sent as a shutdown warning
  238.                                         when ksd receives a SIGUSR2
  239.  
  240.           */.HSResource/*               Directory for storing the
  241.                                         resource fork of files
  242.  
  243.           */.HSancillary                File for additional file
  244.                                         information needed by Mac
  245.  
  246.           ~/.KSVols (or $HOME/.KSVols on HP-UX)
  247.                                         User's personal volume
  248.                                         specification files
  249.  
  250.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  251.           _K-_A_S_h_a_r_e _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e
  252.           _K-_T_a_l_k _A_d_m_i_n_i_s_t_r_a_t_o_r'_s _G_u_i_d_e
  253.           _w_h_o(1), _k_s_d__r_e_s_t_a_r_t(1m), _k_s_d__m_s_g(1m), _k_a_t_s(1), _k_u_n_a_r_c(1),
  254.           _k_a_t_y_p_e(1),
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 5/4/100)
  262.  
  263.  
  264.  
  265.